home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xi / XDeviceBell.z / XDeviceBell
Encoding:
Text File  |  2002-10-03  |  4.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXDDDDeeeevvvviiiicccceeeeBBBBeeeellllllll((((3333XXXX11111111))))  XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))   XXXXDDDDeeeevvvviiiicccceeeeBBBBeeeellllllll((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XDeviceBell - ring a bell on a device supported through the
  10.           input extension
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           Status XDeviceBell(_d_i_s_p_l_a_y, _d_e_v_i_c_e, _f_e_e_d_b_a_c_k_c_l_a_s_s,
  14.           _f_e_e_d_b_a_c_k_i_d, _p_e_r_c_e_n_t)
  15.                 Display *_d_i_s_p_l_a_y;
  16.                 XDevice *_d_e_v_i_c_e;
  17.                 XID *_f_e_e_d_b_a_c_k_c_l_a_s_s;
  18.                 XID *_f_e_e_d_b_a_c_k_i_d;
  19.                 int *_p_e_r_c_e_n_t;
  20.  
  21.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  22.           _d_i_s_p_l_a_y     Specifies the connection to the X server.
  23.  
  24.           _d_e_v_i_c_e      Specifies the device with which the bell is
  25.                       associated.
  26.  
  27.           _f_e_e_d_b_a_c_k_c_l_a_s_s
  28.                       Specifies the class of the feedback with which
  29.                       the bell is associated.
  30.  
  31.           _f_e_e_d_b_a_c_k_i_d  Specifies the id of the feedback with which the
  32.                       bell is associated.
  33.  
  34.           _p_e_r_c_e_n_t     Specifies the volume in the range -100 to 100 at
  35.                       which the bell should be rung.
  36.  
  37.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.           The _X_D_e_v_i_c_e_B_e_l_l request causes the server to ring a bell on
  39.           the specified feedback of the specified device, if possible.
  40.           The specified volume is relative to the base volume for the
  41.           bell.  If an invalid device is specified, a _B_a_d_D_e_v_i_c_e error
  42.           will be returned.  The feedbackclass and feedbackid
  43.           parameters contain values returned by an _X_G_e_t_F_e_e_d_b_a_c_k_C_o_n_t_r_o_l
  44.           request and uniquely identify the bell to ring.  If a
  45.           feedbackclass is specified that does not support a bell, or
  46.           if a nonexistent feedbackid is specified, or a percent value
  47.           is specified that is not in the range -100 to 100, a
  48.           _B_a_d_V_a_l_u_e error will be returned.
  49.  
  50.           The volume at which the bell is rung when the percent
  51.           argument is nonnegative is:
  52.  
  53.                base - [(base * percent) / 100] + percent
  54.  
  55.           The volume at which the bell rings when the percent argument
  56.           is negative is:
  57.  
  58.                base + [(base * percent) / 100]
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXDDDDeeeevvvviiiicccceeeeBBBBeeeellllllll((((3333XXXX11111111))))  XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))   XXXXDDDDeeeevvvviiiicccceeeeBBBBeeeellllllll((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           To change the base volume of the bell, use
  75.           _X_C_h_a_n_g_e_F_e_e_d_b_a_c_k_C_o_n_t_r_o_l.
  76.  
  77.           _X_D_e_v_i_c_e_B_e_l_l can generate a _B_a_d_D_e_v_i_c_e or a _B_a_d_V_a_l_u_e error.
  78.  
  79.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  80.           _B_a_d_D_e_v_i_c_e   An invalid device was specified.  The specified
  81.                       device does not exist, or has not been opened by
  82.                       this client via _X_O_p_e_n_I_n_p_u_t_D_e_v_i_c_e.
  83.  
  84.           _B_a_d_V_a_l_u_e    An invalid feedbackclass, feedbackid, or percent
  85.                       value was specified.
  86.  
  87.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  88.           XChangeFeedbackControl(3X), XBell(3X)
  89.           _P_r_o_g_r_a_m_m_i_n_g _W_i_t_h _X_l_i_b
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.